home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / DIAG / INTR26B.ARJ / INTPRINT.DOC < prev    next >
Text File  |  1990-10-14  |  6KB  |  127 lines
  1.                 INTPRINT v1.40
  2.                             by Ralf Brown
  3.  
  4. The INTPRINT program is hereby donated to the public domain, with the sincere
  5. hope that proper credit will be retained in all copies and derivatives.
  6.  
  7. ------------------------------------------------------------------------------
  8.  
  9. INTPRINT.COM is a VERY simple formatter for the interrupt list.  Use
  10. this program to prevent widow at the beginning of a function call,
  11. number the pages, center the printout in elite (12 cps) mode, or create
  12. a summary of the function calls.  After formatting is complete, the
  13. total number of pages is displayed on the screen.
  14.  
  15. Usage:
  16.    intprint [options] [lines_per_page [page_length]] <interrup.lst [>outfile]
  17.  
  18. where the options are:
  19.     -b    boldface the title lines, Return:, and Notes: by overprinting
  20.     -B    boldface by sending Epson control sequences
  21.  
  22.         -p    print the page number at the bottom center of each page
  23.  
  24.         -iN   indent the output N spaces.  The output device is assumed to be
  25.               at least 80+N characters wide.
  26.               NOTE: you must put the number immediately after the 'i', no
  27.               blanks are allowed.
  28.  
  29.         -e    assume printer is in elite mode (96 characters per line), and
  30.               indent the output eight spaces to center the printout.
  31.  
  32.         -E    assume the printer is an Epson FX80 or compatible, and send
  33.               control sequences to place the printer in elite mode and center
  34.               the printout.  This option overrides -e and forces -i8
  35.  
  36.         -I    assume the printer is capable of producing IBM character graphics
  37.  
  38.         -nN   assume N pages have already been printed, and start numbering
  39.               at N+1.  This option allows you to create a properly-numbered
  40.               printout even if there is not enough disk space to concatenate
  41.               the parts of the interrupt list.  See the examples below.
  42.               NOTE: you must put the number immediately after the 'n', no
  43.               blanks are allowed.
  44.  
  45.     -rN:M print only pages N through M.  The entire input is processed
  46.           for use in -s and -f summaries (see below) even though only
  47.           a portion is formatted for printing.
  48.           NOTE: you must put the page numbers immediately after the 'r',
  49.           no blanks are allowed.
  50.  
  51.     -wN   (widow lines) search N lines from the end of the page for a
  52.           good place to break.  The default is ten lines; the valid
  53.           range is from 3 to one-half of the page length.
  54.  
  55.         -sfile  create a one-line-per-function summary and write it to "file"
  56.               if -n is also given, the summary will be appended to "file",
  57.               allowing a properly numbered summary file to be created even if
  58.               there is not enough disk space to concatenate the parts of the
  59.               list.  See the examples below.
  60.               NOTE: you must put the filename immediately after the 's', no
  61.               blanks are allowed.
  62.  
  63.         -ffile  create a file containing only the data structures described
  64.               in the interrupt list.
  65.               NOTE: you must put the filename immediately after the 'f', no
  66.               blanks are allowed.
  67.  
  68. Options may not be combined; "-ep" is illegal and the "p" will be ignored.
  69.  
  70. Lines_per_page specifies how many lines to print on each page (including the
  71. optional page number), and defaults to 60.
  72.  
  73. Page_length specifies how many lines are on a printed page.  If this value is
  74. omitted, a form feed is used to skip to the next page.  If specified, line
  75. feeds are used to skip to the next page.
  76.  
  77. The file to be formatted is read from standard input, and the formatted result
  78. is sent to standard output.  Both may be redirected using the standard Unix or
  79. MSDOS redirection characters < and >.  If you only want a summary file or
  80. data formats file, redirect the output to the null device ("NUL" under MSDOS,
  81. "/dev/null" under Unix).
  82.  
  83. ------------------------------------------------------------------------------
  84.  
  85. EXAMPLES:
  86. ---------
  87.  
  88.         Print the interrupt list with page numbers, and create a summary file,
  89.     without concatenating INTERRUP.A, INTERRUP.B, and INTERRUP.C:
  90.  
  91.                 A> intprint -sb:interrup.sum -p <interrup.a >prn
  92.         116 pages.   [screen output from INTPRINT]
  93.         A> intprint -sb:interrup.sum -p -n116 <interrup.b >prn
  94.         261 pages.   [screen output from INTPRINT]
  95.         A> intprint -sb:interrup.sum -p -n261 <interrup.c >prn
  96.         386 pages.   [screen output from INTPRINT]
  97.  
  98.         Create only a summary file:
  99.  
  100.                 C> intprint -sinterrupt.sum <interrup.lst >nul
  101.  
  102.         Print the interrupt list on an Epson FX80, using 54 lines per page and
  103.         omitting both page numbers and summary:
  104.  
  105.                 C> intprint -E 54 <interrup.lst >prn
  106.  
  107.     Print the interrupt list using 120 lines on every 132-line page (using
  108.     superscript mode, for example), and make divider lines using IBM
  109.     character graphics:
  110.  
  111.                 C> intprint -I 120 132 <interrup.lst >prn
  112.  
  113.     Print only pages 123 through 127, assuming that 106 pages are contained
  114.     in the first section of the list:
  115.  
  116.         C> intprint -n106 -r123:127 <interrup.b >prn
  117.  
  118. ------------------------------------------------------------------------------
  119.  
  120. PORTABILITY:
  121. ------------
  122.  
  123. INTPRINT.C contains the source code for INTPRINT, for those people who are
  124. using the interrupt list on a machine which does not run MSDOS.  This code has
  125. been tested with Turbo C and Mach (BSD 4.3 Unix) "cc".
  126.  
  127.